home *** CD-ROM | disk | FTP | other *** search
/ MacFormat 1999 May / macformat-076.iso / Shareware Plus / Utilities / NameChum 2.1.0 FAT / NameChum ReadMe < prev    next >
Encoding:
Text File  |  1999-01-17  |  17.2 KB  |  281 lines  |  [ttro/ttxt]

  1. NameChum 2.1.0
  2.  
  3.  
  4.  
  5.  
  6.  
  7. Rocco Moliterno
  8. v. Luserna di Rora' 23
  9. 10139 Torino
  10. Italy
  11.  
  12. e-mail:    yellowsoft@geocities.com (preferred)
  13. alternate: yellowsoft@usa.net
  14.                yellowsoft@iol.it
  15. Web Site:          http://yellowsoft.tsx.org/
  16.                           http://yellowsoft.homepage.nu/
  17.                           http://www.geocities.com/SiliconValley/Network/7162/ 
  18.                           http://users.iol.it/yellowsoft/
  19. Sax index page: http://mini.net/cgi-bin/sax?4029
  20.  
  21.  
  22.  
  23.  
  24. NameChum page: http://www.geocities.com/SiliconValley/Network/7162/namechum.html
  25.  
  26. (Reading this file or WEB Pages of above, please, consider that English is not my primary language. I did my best...)
  27.  
  28. Overview.
  29. NameChum is a useful application for changing the name of files, folders and disks. It can add prefix and/or suffix by using one of offered options:
  30.  * user's choice,
  31.  * date,
  32.  * time,
  33.  * progressive number. 
  34. Moreover NameChum has other cool features for working on names: 
  35.  * searches/replaces characters,
  36.  * removes any number of characters starting from whatever position into names,
  37.  * truncates start and/or end of names.
  38.  
  39. Through preferences you may decide:
  40.  * the default action,
  41.  * the default job system,
  42.  * whether NameChum should scan directories,
  43.  * whether it should change names of directories,
  44.  * whether it should restart the progressive number at each session,
  45.  * whether it should try to set the extensions of names following the Internet Config "File Mapping" setting,
  46.  * whether it should set the extensions of names following only the Internet Config File Mapping" setting,
  47.  * up to four file type to ignore during the renaming,
  48.  * up to four file type to rename, ignoring the other ones. 
  49.  
  50. NameChum is useful for normal desktop usage, but is cool when works, fine, fast and in background, with thousands of files.
  51. By using hot keys you may skip the "request" dialog and changing, on the fly, by using the default action. Moreover there's a key for setting the preferences before work.
  52. The Eraser is Internet Config, Drag Manager and Navigation Manager aware, moreover it's Appearance savvy.  It requires at least System 7 to run.
  53.  
  54. What's new in 2.1.0 version
  55. • Unique FAT version.
  56. • Acceleration buffer.
  57. • Improved testing procedure.
  58. • "Scan of directories" option.
  59. • Mofidied "Remove from char/to char" option.
  60. • Added general counter.
  61. • Counters are now session related instead than globals.
  62. • Windows position saving.
  63. • Added Hot Key for setting preferences before works.
  64. • Optimized Drag Manager support.
  65. • Improved Modal Dialog filters.
  66. • Better break keys management.
  67. • Better alerts.
  68. • Better error checking.
  69. • Better error infos.
  70. • Improved "Internet" routines.
  71. • New trial time term.
  72. • Moved preferences file to Yellowsoft folder.
  73. • Removed custom CDEFs.
  74. • Appearance savvy.
  75. • Navigation Manager aware.
  76. • Notification Manager support.
  77. • Linked with Internet Config 2.0.
  78. • Linked with MoreFiles 1.4.9.
  79. • Linked with Appearance SDK 1.03.
  80. • Recompiled with Interfaces-Libraries 3.2.
  81. • Recompiled by using the newest compiler.
  82. • Addresses update.
  83. • All code revisited.
  84.  
  85. Hardware and software requirements.
  86. NameChum should work on any Macintosh using, at least, System 7. It's accelerated for PowerPC.  Whether you've Appearance Manager you may take advantage of it. The same for Navigation Manager. Some menu items may be disabled if you don't have Internet Config 2.0 installed (only on PowerMac).
  87.  
  88. How it works.
  89. You can open disks, folders, files by Drag&Drop onto  NameChum desktop icon, by selecting them through "File" menu or by dragging theirs icons on  NameChum  main window.
  90. After dragging on some items, the "Setting Dialog" appears:
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106. This dialog shows the main elements of your preferences (see below…) you can temporary change them without affect the preferences. If you don't want to add prefix or suffix simply set one of two checkboxes or else (if your selection is "user") simply let empty the related edit field.
  107. Note: if you're using the "Use only Internet Config" feature (see below), the "Setting Dialog" never appears.
  108.  
  109. After you have pressed the "OK" button and while NameChum is working, the "Info Window" window returns some informations.
  110.  
  111. Preferences.
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. The controls are auto-explaining, I think...
  137. The upper elements will be shown in the "Setting Dialog" when you drag on some items, besides NameChum uses they when you're using a HotKey (see below)…
  138. The first pop up menu allows you to set your preferred prefix, the second sets the suffix. There are four options for each one and you can combine them. The options are: 
  139.     √...users (the extension you want), 
  140.     √...date in short format (the separator is "-"), 
  141.     √...time with seconds (the separator is "|"),  
  142.     √...progressive number. The checkbox "Restart numbers" reset the numbers to zero at the end of any work session.
  143. Be careful: if you select "user", please, don't add the separator period, NameChum adds it automatically.
  144. To change even directories names, check the checkbox "Name of directories".
  145. Note: "Name of directories" and Internet options (see Internet Config…) can't work together. Disabling "Scan directories" allows you to change just the names of file opened, without any scan. For infos about "Acceleration buffer" option, see "Last Info" section…
  146.  
  147. The fifth pop up menus option is "Search for/Replace with". If you set "Search for" in the first pop up menu, NameChum automatically sets "Replace with" in the second. And vice versa. When this option is on you can search/replace in the name of files. You must insert some text in the upper edit field, but you can leave blank the lower (this configuration is very cool for removing extensions from names…).  The search is case sensitive.
  148.  
  149. The sixth pop up menus option is "Remove from char/To char". If you set "Remove from char" in the first pop up menu, NameChum automatically sets "To char" in the second. And vice versa. When this option is on you can remove, from names, the number of characters you want starting from any char in the name. You must insert some number in both edit fields. If the "Remove from char" number is greater than the size of the name currently examinated, NameChum don't change the name. If the "To char" number is greater than the size of the name currently examinated, NameChum sets it to the name size.
  150.  
  151. The seventh pop up menus option is "Char to remove from start/Char to remove from end". If you set "Char to remove from start" in the first pop up menu, NameChum automatically sets "Char to remove from end" in the second. And vice versa. When this option is on you can remove, from names, the number of characters you want starting from the beginning or from end of names. If you leave blank an edit field or else a number is greater than the size of the name currently examinated, then NameChum doesn't cut the related side of name.
  152.  
  153. In the "Preferences Dialog" you can set four file type (just in the "Skip files of type" area), if NameChum, while is running, finds a file having type matching one of four type you have set, then lets its name untouched. You can also set four further file type (in the "Treat only files of type" area),  if NameChum, while is running, finds a file having type matching one of four type you have set, then change its name, contrariwise lets it untouched.
  154. If  both "Skip" and "Trat only" features are active, "Skip" has the priority, so if you tell NameChum to skip and treat the same type then it lets the file name untouched.
  155. Note:  in both "Skip files of type" and "Treat only files of type" areas, you may find a checkbox to the left of each of the 8 boxes for the types. The way to use this feature is:
  156.             ◊ type the four letter code for the filetype (or choose a file type by the button to the left of the checkbox);
  157.             ◊ check the checkbox  (using the mouse).
  158. If you don't check the checkbox then the typed code is not used by NameChum .  In fact, if you close the dialog (by pressing the "OK" button) and then re-open it, then the four-letter code that you have just entered (but forgot to check the checkbox)  is not there!  It has disappeared! So, I hope you understand because the checkbox is there: simply for security confirmation.  Furthermore if you check the checkbox but don't insert some text in the related field, when you re-open  the "Preferences Dialog" the checkbox will be un-checked.
  159. Are you perplexed about "Skip files of type" and "Treat only files of type" features? If you don't perceive theirs sense, simply don't activate them. When you need them you will understand them!
  160.  
  161. Internet Config.
  162. Through the "Preferences" Dialog you can activate a cooperation with Internet Config (if available). When you open Internet Config (you may use the NameChum "Internet" menu to open it) you find this button:
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169. by pressing "File Mappings" button the "File Mappings" window appears:
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199. from Internet Config documentation:
  200. "The File Mappings window lets you view and edit the table that is used to set the Macintosh file type and creator of incoming files based on their extension. If you don't understand this window then please don't worry. We've done our best to set up appropriate defaults. If you have any problems with file transfers, then resetting to factory defaults will probably help."
  201.  
  202. Well, in fact File Mappings is an useful, customizable, database of types, creators and name exensions that NameChum may use with benefit:
  203.             ◊ If you check "Try Internet Config" checkbox then NameChum attempts first to add an extension name by using Internet Config  File Mappings, if fails then follows your setting. This is an optimal option.
  204.             ◊ If you check "Use only Internet Config" checkbox then NameChum attempts to add an extension name by using Internet Config  File Mappings, if fails then ignores your setting and, consequently, the file currently examinated.
  205. Note: even if you're using  Internet Config  File Mappings, NameChum always considers "Types to skip" and "Treat only files of type" (if active).  Internet settings automatically disable"Name of directories" checkbox.
  206.  
  207. Hot Keys.
  208. NameChum has some useful Hot Keys. When you're using these keys NameChum skips always the "Setting Dialog" and  shows immediately the "Info Window", making its job:
  209. <command> = if you hold down this key then NameChum adds only the prefix, by using the preferred prefix or,  if  suitable and if you've set "Try Internet Config",  by using File Mappings.
  210. <control> = the same of above, but concerning the suffix.
  211. <command+control> = the same of above, but concerning both prefix and  suffix.
  212. <option> = open the Preferences before continue.
  213. Note: if  "Use only Internet Config" feature is active then NameChum ignores command and control Hot Keys.
  214.  If you've set, in the preferences, "Search for/Replace with", "Remove from char/To char" or "Char to remove from start/Char to remove from end" options, you may use only one of two first modifier as Hot Key.
  215. Normally you can press Escape key to break changing.
  216.  
  217.  
  218. Menus.
  219. You may  perform any action of above by using  the "Open" menuitem inside the File Menu. You can also use Hot Keys, while you're selecting a file.
  220. From Internet Menu you can launch Internet Config, send me e-mails, visit my web pages or copy my addresses.
  221.  
  222. Last Info.
  223. NameChum works following this way: 
  224.    1) builds the new name 
  225.    2) tell the Finder to rename the file. 
  226. But working with name is complex rather than simple and, if the Finder doesn't accept the new name, it can have several reasons, each one well-founded. Troubles can occur, mainly, for some invalid characters or else for some weird alchemy, also files can be locked or else can have name locked…so don't be surprised, if sometimes, the result is different than your expectation, there's a valid cause.
  227. There's another problem dragging/opening  folders, instead than theirs contents: after changing the name of an item, the System also changes its folder indexation so, working by using this index, a single file may be processed two (or more) time but never a different one. 
  228. Bad thing.
  229. If you check "Acceleration buffer" inside Preferences, NameChum first collect file infos into memory, then change the names, directly from memory without any indexation.
  230. If you let unchecked "Acceleration buffer" then NameChum uses indexation…but, to avoid indexation troubles, it keeps, into memory, infos about files already renamed then, to change the "lost" files even, it    tests directories up to 4 times. In this case you should observe the Info Window, there are two counters: "Names changed" and "Counter".  If both counters show the same number then NameChum skips the remaining tests. Anyway you may skip Tests by pressing (softly) escape key.
  231.  
  232. Remember also that, using Drag Manager, NameChum collects infos into memory, before processing files, so if you want to drag a hell of a lot of files or if you want to work on directories, make sure to set rationally the NameChum memory partition size. 
  233.  
  234. Acknowledgement.
  235.     √...Carla "The Stylist" Bidone.
  236.     √...Lucilla Guendalina "The Leader"  Moliterno.
  237.     √...Fabrizio Oddone.
  238.     √...Jim Stout.
  239.  
  240. Author's note:
  241. My software development group is made up by: me.
  242. On the other hand, my beta-tester group is made up by: me.
  243. This means that if you find a bug, both developer and beta-tester groups would greatly appreciate your reporting ;-)
  244. And don't forget to register your copy of NameChum.  Remember that a shareware author should be supported.  If you don’t pay for shareware software today, you will pay much more tomorrow for exactly the same features (but enclosed in a 'nice' commercial box).
  245.  
  246. Version history.
  247. 2.1.0 Unique FAT version. Acceleration buffer. Improved testing procedure. "Scan of directories" option. Mofidied "Remove from char/to char" option. Added general counter. Counters are now session related instead than globals.Added Hot Key for setting preferences before works. Windows position saving. Optimized Drag Manager support. Improved Modal Dialog filters. Better break keys management. Better alerts. Better error checking. Better error infos. Improved "Internet" routines. New trial time term. Moved preferences file to Yellowsoft folder. Removed custom CDEFs. Appearance savvy. Navigation Manager aware. Notification Manager support. Linked with Internet Config 2.0. Linked with MoreFiles 1.4.9. Linked with Appearance SDK 1.03. Recompiled with Interfaces-Libraries 3.2. Recompiled by using the newest compiler. Addresses update. All code revisited.
  248. 2.0.0 This is a totally new application.
  249. 1.0.0  19 Jan 95, first release, named FilePreSuf.
  250.  
  251. SHAREWARE $10 CASH.
  252. NameChum is distributed as SHAREWARE: if you use NameChum you should pay the author. 
  253. You may register by sending US $10 CASH ONLY (or an equivalent sum with your local currency) to the author at the address above. A shareware registration form is available inside NameChum.
  254. Please, please, no checks: to cash them I must pay the bank more than $18!!!!! if you  nevertheless want to pay, in any case, by using checks, the requested price increases by $18, to a total of $28 for an individual.
  255.              I will trash, without reply, any check without the $18 contribution.
  256. for fees over $50 I suggest you use an international postal money order.
  257.  
  258. Special licences.
  259. Pricing:
  260.     √...Site licence:         US $ 200
  261.     √...Country licence:  US $ 500   (a licence to use the software in any your office in one country)
  262.     √...World licence:     US $ 1000 (a licence to use the software in any your office around the world)
  263.  
  264. To register a special licences, please follow this steps:
  265. 1) send an international postal money order to the address above,
  266. 2) send me a letter or an e-mail containing your personal data (the same data requested in the "normal" registration form).
  267.  
  268. The unregistered version.
  269. After the trial period of one week, the unregistered version of NameChum is, still, fully operational; however it will always show a reminder and its "about" box when you open it. When you register NameChum the irritating windows don't appear and the "unregistered" notice will be replaced by the registration information.
  270. Notice: soon after registering, you will receive the serial number via e-mail. 
  271.  
  272. Distribution.
  273. NameChum is ©1995-99 by Rocco Moliterno. It can be freely distributed without my prior permission, without any changes and with this "Read Me" from:  online services, BBS, non-profit user groups, people and individuals.
  274. NameChum can also be included, without my prior permission, without changes and with this "Read Me", in all CD-ROM or disk shareware collections and in all CD-ROM or Disk magazines  (anyway an e-mail or a snail mail would be welcome,  as well a copy of the magazine or media would be welcome  :-).
  275. NameChum may not be included in a commercial package without my prior permission.
  276.  
  277. Where's the 1.x.x version?
  278. NameChum 2.x.x is based on a (very old and never updated) application of mine: FilePreSuf 1.0.0. Since the totally new interface and features I've changed the FilePreSuf name. This is all. 
  279.  
  280. Disclaimer of Warranty.
  281. This software is provided "as is" and without warranty of any kind, implied or expressed. When using it you assume all responsibility for any damages caused, directly or indirectly, by its use. Also registering this software doesn’t give you the right to require extra services (bug fixing, special assistance, the latest version on disk, and so on): you should pay only because you think the program you’re using now is worth the money